Update Appveyor badge docs

* indicate you can specify the appveyor project id if you want to use that instead

This PR is part of: https://github.com/rust-lang/crates.io/issues/693

Auto merge of #4485 - integer32llc:clarify-config, r=alexcrichton

Clarify that .cargo/config files are unified

It wasn't immediately clear to me from the text on this page whether Cargo looks for these files and stops at the first one, or whether it looks for them all and puts them all together. I was pretty sure it was the latter, but I think these few more words would have made me feel more confident sooner :)

Clarify that .cargo/config files are unified

Auto merge of #4480 - integer32llc:explain-labels, r=matklad

Add an explanation of the labels

As requested @matklad! ❤️ Are there any questions you have about the labels that remain unanswered?

Document the relnotes label too

Add an explanation of the labels

Auto merge of #4469 - nipunn1313:workspace_features, r=alexcrichton

Hashed dependencies of metadata into the metadata of a lib

This fixes one part of #3620. To my understanding, the more fundamental fix is more challenging

Make `dep_targets` consistent throughout compilation

Previously it depended on dynamic state that was calculated throughout a
compilation which ended up causing different fingerprints showing up in a few
locations, so this makes the invocation deterministic throughout `cargo_rustc`.

DP Cache target_metadata. Update all the lifetimes

Cleanup debug statements

Refactor to share code from dep_targets. Fixes the plat-specific case

get doctests to pass

Hashed dependencies of metadata into the metadata of a lib

Auto merge of #4464 - matklad:document-all-the-things, r=alexcrichton

Mention sccache in the guide

Closes  #4307

Mention sccache in the guide

Auto merge of #4477 - alexcrichton:fix-out-of-bounds, r=matklad

Use poll instead of select to handle large fds

It may be the case that Cargo's running around with a lot of file descriptors,
and in this case we wouldn't be able to call `select` due to the file
descriptors being too large and not fitting in the bit array. This switches to
what the standard library is currently doing, using `poll`, which doesn't have
this limitations.

Auto merge of #4476 - behnam:book, r=alexcrichton

[doc/book] Move section content to */index.md

This gives a better over-all structure to the book, which we can also
follow for other books on <doc.rust-lang.org>.

Also, confirming fix for broken links with the latest (0.0.24) `mdbook`
release.

Auto merge of #4473 - wesleywiser:cyclical_features, r=matklad

Allow features to be cyclical

Fixes #3796

Auto merge of #3992 - alexcrichton:replace-git, r=matklad

Support vendoring git repositories

Currently the vendoring support in Cargo primarily only allows replacing
registry sources, e.g. crates.io. Other networked sources of code, such as git
repositories, cannot currently be replaced. The purpose of this commit is to
support vendoring of git dependencies to eventually have support implemented in
the `cargo-vendor` subcommand.

Support for vendoring git repositories required a few subtle changes:

* First and foremost, configuration for source replacement of a git repository
  was added. This looks similar to the `Cargo.toml` configuration of a git
  source.

* The restriction around checksum providing sources was relaxed. If a
  replacement source provides checksums but the replaced source doesn't then
  that's now considered ok unlike it being an error before.

* Lock files can be generated for crates.io crates against vendored sources, but
  lock files cannot be generated against git sources. A lock file must
  previously exist to make use of a vendored git source.

* The `package` field of `.cargo-checksum.json` is now optional, and it is
  intended to be omitted for git sources that are vendored.

Use poll instead of select to handle large fds

It may be the case that Cargo's running around with a lot of file descriptors,
and in this case we wouldn't be able to call `select` due to the file
descriptors being too large and not fitting in the bit array. This switches to
what the standard library is currently doing, using `poll`, which doesn't have
this limitations.

[doc/book] Move section content to */index.md

This gives a better over-all structure to the book, which we can also
follow for other books on <doc.rust-lang.org>.

Also, confirming fix for broken links with the latest (0.0.24) `mdbook`
release.

Allow features to be cyclical

Fixes #3796

Auto merge of #4472 - alexcrichton:update, r=matklad

Update dependencies

Just a usual `cargo update` plus moving over some major versions

Auto merge of #4461 - behnam:policies, r=alexcrichton

[doc] Redirect /policies.html to crates.io/policies

This relieves us from migrating the Package Policies document into the
new Cargo Manual mdbook.

Moved the content to `crates.io` repo in
<https://github.com/rust-lang/crates.io/pull/1033>.

NOTE: We should wait until that change goes live before landing this
one. I'll notify here when it's time to land.

Closes <https://github.com/rust-lang/crates.io/issues/1030>

[doc/book] Drop Policies link from Reference page

[doc/header] Update Policies URL

[doc] Redirect /policies.html to crates.io/policies

This relieves us from migrating the Package Policies document into the
new Cargo Manual mdbook.

Moved the content to `crates.io` repo in
<https://github.com/rust-lang/crates.io/pull/1033>.

NOTE: We should wait until that change goes live before landing this
one. I'll notify here when it's time to land.

Closes <https://github.com/rust-lang/crates.io/issues/1030>

Update dependencies

Just a usual `cargo update` plus moving over some major versions

Support vendoring git repositories

Currently the vendoring support in Cargo primarily only allows replacing
registry sources, e.g. crates.io. Other networked sources of code, such as git
repositories, cannot currently be replaced. The purpose of this commit is to
support vendoring of git dependencies to eventually have support implemented in
the `cargo-vendor` subcommand.

Support for vendoring git repositories required a few subtle changes:

* First and foremost, configuration for source replacement of a git repository
  was added. This looks similar to the `Cargo.toml` configuration of a git
  source.

* The restriction around checksum providing sources was relaxed. If a
  replacement source provides checksums but the replaced source doesn't then
  that's now considered ok unlike it being an error before.

* Lock files can be generated for crates.io crates against vendored sources, but
  lock files cannot be generated against git sources. A lock file must
  previously exist to make use of a vendored git source.

* The `package` field of `.cargo-checksum.json` is now optional, and it is
  intended to be omitted for git sources that are vendored.

Auto merge of #4467 - RalfJung:locked, r=alexcrichton

fix error message when --locked is passed but lockfile is outdated

The logic is currently the wrong way around, saying I passed `--frozen` when I really passed `--locked`.

I had no idea where to put the test...

fix error message when --locked is passed but lockfile is outdated

Auto merge of #4465 - matklad:yak-shaving, r=alexcrichton

Add CONTRIBUTING.md

r? @alexcrichton

Add CONTRIBUTING.md

Auto merge of #4462 - behnam:book-fixes, r=alexcrichton

[doc/book] Drop reference/policies.md and small fixes

We don't need to put `policies.md` in the book. See
<https://github.com/rust-lang/crates.io/issues/1030> for more.

Renaming `introduction.md` to `index.md` prevents creating two html
files (and URL) for one source.

The rest are small styling issues.

Tracker: <https://github.com/rust-lang/cargo/issues/4040>

[doc/book] Drop reference/policies.md and small fixes

We don't need to put `policies.md` in the book. See
<https://github.com/rust-lang/crates.io/issues/1030> for more.

Renaming `introduction.md` to `index.md` prevents creating two html
files (and URL) for one source.

The rest are small styling issues.

Tracker: <https://github.com/rust-lang/cargo/issues/4040>

Auto merge of #4457 - behnam:book-pub, r=alexcrichton

[doc] Publish book to gh-pages

Export mdBook into `target/doc/book/`, to make it accessible at <http://doc.crates.io/book/>

I have tested the changes on my repo (but when I had this commit on top of the other PR) locally. The result is at <http://code.behnam.es/rust-cargo/book/>.

Tracker: <https://github.com/rust-lang/cargo/issues/4040>

[doc/book] Rename crates-io.md to publishing.md

[doc] Add back heading to index.md

[doc] Publish book to gh-pages

Auto merge of #4455 - behnam:book-enh, r=alexcrichton

[doc/book] Add introduction page and other enhancements

Preview: http://code.behnam.es/rust-cargo/book/

* Reorganize files to use folders instead of numbered files. This will allow us to add new sections and pages without breaking a numbering system or the URLs.

* Rename "Cargo In Depth" to "Cargo Reference", as those pages are considered *the* reference for cargo behaviors.

* Add `introduction.md`, as the landing page with the book title and Cargo logo on top.

* Expand `installation.md`: Import install text and links from <https://crates.io/install>, as we
want to drop that page and redirect it to here. (See <https://github.com/rust-lang/crates.io/issues/1029>)

* Sync `SUMMARY.md` titles (and sub-pages lists in section pages) with page titles and fix some wordings and casings.

* Expand Introduction and section pages with some intro text.

* Set lang for some of the code blocks.

* Add `book.toml` to get the title in HTML head title, etc.

Tracker: <https://github.com/rust-lang/cargo/issues/4040>

[doc] Sync back doc/book changes into old docs

[doc/book] Add book.toml

[doc/book] Final touches to introduction.md

[doc/book] Assign langs to more code blocks

[doc/book] Create dir for book sections

[doc/book] Improve page titles

[src/doc/book] Add introduction page

[doc/book] Expand installation.md

Import install text and links from <https://crates.io/install>, as we
want to drop that page and redirect it to here.

See <https://github.com/rust-lang/crates.io/issues/1029>

Auto merge of #4453 - behnam:book, r=alexcrichton

Import mdBook-based docs and sync

Since we decided to keep the mdBook-based docs in-repo, I have imported the existing converted docs from <https://github.com/istankovic/cargo-book> under `/src/doc/book/` here, and have synced the current docs and the mdBook-based ones manually, file-by-file.

I have created a `MIGRATION_MAP` file, which shows the relationship between old docs and new ones. The first column is the old file, the second column is the canonical location in mdBook, and the rest of columns are globs of other files in mdBook containing content from the old file.

The first and second column of `MIGRATION_MAP` shall later be used to create redirect rules from `doc.crates.io/` to `doc.rust-lang.org/cargo/`.

I will also add a README file to remind everyone to keep these files in sync during the migration.

There are also two or three small wording fixes here, which I'll note inline.

This is a retry of <https://github.com/rust-lang/cargo/pull/4220>.

First step for <https://github.com/rust-lang/cargo/issues/4040>.

Auto merge of #4447 - lucaskolstad:proc-macro-crates-host-deps-linkage, r=alexcrichton

Add host dependency path via -L for cargo_test.

Proc-macro crates' dependencies in the host dependency directory cannot
be found when running `cargo test` with the `--target {target}` flag
set as reported in #4224. This adds the host dependency directory to the
search path to find those missing dependencies with -L when building tests
and adds a test case that fails before and passes after this patch.

A new function `find_host_deps(..)` is added to accomplish this which can
determine the path of the host dependencies directory from within
`run_doc_tests(..)` where the missing library search path is needed.

Fixes #4224
Fixes #4254

Modeled after a similar patch: a298346d6e8862992be3fd93dd8a6c833cc72719

**Concerns**

The test case seems to require a non-local crate from crates.io to example the failure before this patch. Couldn't make it fail with simply another local subcrate, but if others think it's possible that'd be great. This means that during tests for the cargo project itself that this test case actually downloads and compiles a crate, which I don't think any other tests do and is obviously not ideal and is perhaps even unacceptable. I've used the base64 crate pretty arbitrarily, but which crate it is really doesn't matter to test the case's content. So if anyone knows a tiny or empty crate on crates.io to use instead that'd speed this up and if someone can figure out how to make it fail before this patch is applied without downloading an external crate that would help as well.

Also, I'm not 100% confident about the `find_host_deps(..)` style and whether it's the best way to find the host dependencies directory with just the `TestOptions` and `Compilation` structs available since I'm new to this project. Any comments are appreciated.

Tweak proc_macro test to correctly test case.

Minor change causes the test to actually test the case instead of always
passing regardless of the fix that adds the host dependency directory to
the library search path.

[src/doc/book] Use package registry for crates.io

[src/doc/book] Fix header casings

[src/doc/book] Move a paragraph to cargo-in-depth.md

[src/doc/book] Add all sub-chapters to cargo-in-depth.md

[src/doc/book] Drop unused images

[src/doc] Add README.md

[src/doc/book] Update SUMMARY.md

[src/doc/book] Update 03-01-specifying-dependencies.md from specifying-dependencies.md

[src/doc/book] Check 03-08-source-replacement.md

[src/doc/book] Update 03-10-policies.md from policies.md

[src/doc/book] Check 03-07-pkgid-spec.md

[src/doc/book] Update 03-02-manifest.md from manifest.md

[src/doc/book] Apply 01-*.md changes into index.md

Replace plugins_dylib_path with host_deps_output.

The plugins_dylib_path field on Compilation is removed because it is
identical to host_deps_output, it is only used in one easily replaced
location, and because host_deps_output is a more general name that
includes its new usage location in cargo_test.rs as well while better
matching the corresponding deps_output field.

Also de-indents erroneously indented lines in a test case.

[src/doc/book] Update guide.md and 02-*.md from guide.md

[src/doc/book] Check faq.md

[src/doc/book] Update 03-09-external-tools.md from external-tools.md

[src/doc/book] Update 03-04-environment-variables.md from environment-variables.md

[src/doc/book] Update 03-06-crates-io.md from crates-io.md

[src/doc/book] Update 03-05-build-scripts.md from build-script.md

[src/doc/book] Update 03-03-config.md from config.md

[src/doc/book] Add .gitignore

Using `mdbook init` command.

Also, update `.gitignore` file manually and add a leading slash.
(Upstream fix for mdBook: <https://github.com/azerupi/mdBook/pull/413>)

[src/doc/book] Import from cargo-book repo

Remove find_host_deps and use Compilation field.

This patch removes the addition of the find_host_deps() function by
adding a host_deps_output field to the Compilation struct instead. The
test case is altered to not use an external crate from crates.io but
instead use the Package.publish(..) method.

Auto merge of #4451 - steveklabnik:relax-rustdoc-tests, r=alexcrichton

relax rustdoc tests

This was asserting on the output directly, rather than just what it contains.

In https://github.com/rust-lang/rust/pull/44138 we are adding deprecations, and so it
breaks these tests.

Don't use deprecated rustdoc flags in tests

In rust-lang/rust#44138 we are adding deprecations, and so it
breaks these tests.

Auto merge of #4440 - nisargthakkar:publish_target, r=alexcrichton

Adding target support to cargo package and cargo publish

Fixing Issue #4012

Same as #4077 but couldn't reopen the PR due to force push after rebasing from master

Removing redundant extern

Adding tests for --target with cargo publish and cargo package

Adding target support to cargo package and cargo publish

Add host dependency path via -L for cargo_test.

Proc-macro crates' dependencies in the host dependency directory cannot
be found when running `cargo test` with the `--target {target}` flag
set. This adds the host dependency directory with -L when building tests
and a test case that fails before and passes after this patch.

A new function find_host_deps(..) is added to accomplish this which can
determine the path of the host dependencies directory from within
run_doc_tests(..) where the missing library search path is needed.

Fixes #4224
Fixes #4254

Auto merge of #4442 - Xanewok:process-builder-program, r=alexcrichton

Allow to substitute executed program in `ProcessBuilder`

Extends #4424. Sorry for the noise, turns out it'd also be useful to substite the executed program (e.g. for rls, which needs to use a rustc shim itself) without having to copy over manually all parts of the `ProcessBuilder`.

While I'm at it, do you think this needs even more functionality, like being able to specify `None` for the `cwd` or `jobserver` (currently API exposes only ability to specify `Some(...)` as values for those)?

r? @alexcrichton

Auto merge of #4445 - alexcrichton:bump, r=matklad

Bump Cargo to 0.23.0

Fix tests on nightly

Bump Cargo to 0.23.0

Allow to substitute executed program in `ProcessBuilder`

Auto merge of #4441 - vignesh-sankaran:manifest-doc-fix, r=alexcrichton

Replace maintenance status with ellipses

Since the default maintenance status isn't set to none if it isn't set, feel it'd be more appropriate to have ellipses instead like the other badge docs.

Replace maintenance status badge none with ellipses

Auto merge of #4439 - ishitatsuyuki:bench-cleanup, r=matklad

Gate extern crates for bench tests

I tried my best to skim through the `extern crate` statements, and I hope this will unblock the unused extern crates PR.

Fix remaining test failures

tests/cfg: allow unused extern crates

tests/build-script: allow unused extern crates

Gate feature for bench tests

Gate extern crates for bench tests

Auto merge of #4358 - Mark-Simulacrum:fix-cfg-cargo, r=alexcrichton

Discover crate type information late if necessary.

Some crates aren't found during eager crate-type searching due to being behind `cfg(...)` flags. We still want to be able to handle these, though, so when necessary we now call rustc again to get crate-type information for these cfg-ed crates.

This is necessary for https://github.com/rust-lang/rust/pull/41991.

r? @alexcrichton

Auto merge of #4437 - ishitatsuyuki:deps-purge, r=matklad

Purge deps, round 2

Sorry for creating so much iterations, I have no local build of the new compiler :)

Discover crate type information late if necessary.

Some crates aren't found during eager crate-type searching due to being
behind `cfg(...)` flags. We still want to be able to handle these,
though, so when necessary we now call rustc again to get crate-type
information for these cfg-ed crates.

Purge deps, round 2

Auto merge of #4435 - ishitatsuyuki:deps-purge, r=matklad

Purge unused extern crates